				RDS Data Logger Plugin Beta17 for SDRSharp v1627
				-------------------------------------------------

### Disclaimer ###

There is no implicit or explicit warranty for this RDSDataLogger software and you use it at your own risk. By using this software you agree to these terms and that the author of this Plugin is not liable for any direct or indirect damage to your computer, radio, data (etc) from use of this software.

This disclaimer is to be kept alongside the SDRSharp.RDSDataLogger.dll

### Installation ###

1> Extract the zip into your SDRSharp directory which should give you


SDRSharp\SDRSharp.RDSDataLogger.dll
SDRSharp\RDSDataLoggerReadMe1st.txt
SDRSharp\RDSDataLogger\RDSDataLogger-MemBank.CSV

Note that the RDSDataLogger-MemBank.CSV file is in a subdirectory of RDSDataLogger

2> Edit plugins.xml and add the following line at the bottom before the </sharpPlugins> line:

<add key="RDS Data Logger" value="SDRSharp.RDSDataLogger.RDSDataLogger,SDRSharp.RDSDataLogger" />

so it looks like:

<add key="RDS Data Logger" value="SDRSharp.RDSDataLogger.RDSDataLogger,SDRSharp.RDSDataLogger" />
</sharpPlugins>

3> Restart SDRSharp

### Purpose ###

The RDS Data Logger Plugin is designed to log RDS data either by being parked on a single frequency or by using the scan function. The scan function sweeps the FM Band from 87.5 MHz to 108 MHz (by default) looking for any RDS data which it will then (if Auto Log is checked) log to an RDSDataLogger\RDSDataLogger-yyyy-mm-dd.csv file

The scanner (by default) changes frequency every 7 seconds. 
If parked on a single frequency then the RDS data will be reset every 2 minutes (by default) and logged (Note: if the current PI code is the same as the last PI logged it will ignore it)

### User Interface ###

[ON/OFF] Switches plug in on and off

[Start Scan/Stop Scan] Starts/Stops the band scanner
[Log Data Now] Logs immediately

[AF Buttons] Populated by Alternate Frequency (AF) data decoded from the RDS data stream. Clicking the button takes you to the specific frequency.
-- L/U toggle Lock/Unlock AF frequency buttons
[Block Down] Moves down 1 block of frequencies
[Block Up] Moves up 1 block of frequencies

[Mem Scan] Toggles on/off scanning based on a list of pre-defined frequencies (edit RDSDataLogger\RDSDataLogger-MemBank.csv to configure frequencies)
[Log] Toggles on/off auto logging to the RDSDataLogger\RDSDataLogger-yyyy-mm-dd.csv file
[Skip Locals] Toggles on/off skipping of local radio stations (requires creating a local list first, see below)
[Log Every Frequency Change] If enabled this will log into RDSDataLogger\RDSDataLoggerFrequencyLog-yyyy-mm-dd.csv file every frequency change this plugin does. This is useful if you need to cross reference with an external logger such as RDS Spy
[LogRAW] Logs all received RDS data to RDSDataLogger\RDSDataLogger.raw (experimental and will create very large files)

[Find Locals] Does a single sweep of the FM Band to identify any frequencies with RDS data. This will then be used as your local list of frequencies to skip over
[Reset RDS Data] Clears the current captured RDS data

The [50 KHz / 100 KHz / 200 KHz] radio buttons are used to select the step size for the scan function

### Advanced Settings ###

This section allows you to customise some of the internal workings of the RDS Data Logger

[Spectrum Bandwidth] This is the spectrum available in a single block of frequencies. If you wish prefer not to scan at the edges of the spectrum you can reduce this number. For example if you have 5Meg of spectrum but want to scan within the inner 4Meg you would set 4000000 instead of 5000000. This would then chop of 0.5Meg off each end of the spectrum
[Filter Bandwidth] The filter which is set when scanning 
[Sweep Wait Time] The time the scanner sits on a frequency before moving onto the next
[Auto Reset RDS Time] When left on a single frequency (i.e. not scanning) this is the setting to control how often the RDS data is automatically reset
[Scan From] The frequency to start scanning from
[Scan To] The frequency to scan to
[Apply Settings] You need to click this to apply any changes you have made in the advanced section
[Default] Populates the advanced section with the default values

### Uninstall ###

1> Delete SDRSharp.RDSDataLogger.dll from your SDRSharp directory
2> Edit plugins.xml and delete the following line 

<add key="RDS Data Logger" value="SDRSharp.RDSDataLogger.RDSDataLogger,SDRSharp.RDSDataLogger" />

You can optionally also delete your data files from the SDRSharp\RDSDataLogger sub directory

3> Restart SDRSharp

### FAQ ###

Q. How do I make Funcube Dongle Pro+ scan in the middle of the spectrum
A. Set SDRSharp to center tuning (toggle icon to the right of the frequency at the top of the SDRSharp window)

Q. The scan function does nothing
A.1 Is the plugin switched on i.e. does it displays an OFF button rather than an ON button in the top left corner of the Plugin
A.2 Is the plugin able to write to the SDRSharp and RDSDataLogger directories on the machine
A.2 Do you have a RDSDataLogger subdirectory in the SDRSharp installation folder?

Q. I have updated the MemBank file and/or the Local file and nothing has changed
A. You need to restart SDRSharp if you make any manual changes to these files i.e. it reads the files on startup of SDRSharp

################

RDS Data Logger Plugin
Copyright 2015 Andy Pritchard - M0CYP
http://www.apritch.myby.co.uk/sdrsharp_plugins.htm

